.TH std::array::max_size 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::array::max_size \- std::array::max_size

.SH Synopsis
   constexpr size_type max_size() const noexcept;  \fI(since C++11)\fP

   Returns the maximum number of elements the container is able to hold due to system
   or library implementation limitations, i.e. std::distance(begin(), end()) for the
   largest container.

.SH Parameters

   \fI(none)\fP

.SH Return value

   Maximum number of elements.

.SH Complexity

   Constant.

.SH Notes

   Because each std::array<T, N> is a fixed-size container, the value returned by
   max_size equals N (which is also the value returned by size).

.SH Example


// Run this code

 #include <iostream>
 #include <locale>
 #include <array>

 int main()
 {
     std::array<char, 10> p;
     std::array<long, 10> q;

     std::cout.imbue(std::locale("en_US.UTF-8"));
     std::cout << std::uppercase
               << "p.max_size() = " << std::dec << p.max_size() << " = 0x"
               << std::hex << p.max_size() << '\\n'
               << "q.max_size() = " << std::dec << q.max_size() << " = 0x"
               << std::hex << q.max_size() << '\\n';
 }

.SH Output:

 10 = 0xA
 10 = 0xA

.SH See also

   size returns the number of elements
        \fI(public member function)\fP
